home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_exim.idb / usr / freeware / catman / u_man / cat1 / pgrep.Z / pgrep
Encoding:
Text File  |  1999-01-26  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      PPPPGGGGRRRREEEEPPPP((((1111))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV              PPPPGGGGRRRREEEEPPPP((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       pgrep    - a grep with Perl-compatible regular expressions.
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       ppppggggrrrreeeepppp    [[[[----cccchhhhiiiillllnnnnssssvvvvxxxx]]]] ppppaaaatttttttteeeerrrrnnnn [[[[ffffiiiilllleeee]]]] ............
  13.  
  14.  
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.       ppppggggrrrreeeepppp    searches files for character patterns, in the same way
  18.       as other grep    commands do, but it uses the PCRE regular
  19.       expression library to    support    patterns that are compatible
  20.       with the regular expressions of Perl 5. See ppppccccrrrreeee((((3333)))) for a
  21.       full description of syntax and semantics.
  22.  
  23.       If no    files are specified, ppppggggrrrreeeepppp reads the standard input.
  24.       By default, each line    that matches the pattern is copied to
  25.       the standard output, and if there is more than one file, the
  26.       file name is printed before each line    of output. However,
  27.       there    are options that can change how    ppppggggrrrreeeepppp behaves.
  28.  
  29.       Lines    are limited to BUFSIZ characters. BUFSIZ is defined in
  30.       <<<<ssssttttddddiiiioooo....hhhh>>>>.  The newline character is removed from the    end of
  31.       each line before it is matched against the pattern.
  32.  
  33.  
  34.  
  35.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  36.       ----cccc        Do not print individual lines; instead just    print
  37.             a count of the number of lines that    would
  38.             otherwise have been    printed. If several files are
  39.             given, a count is printed for each of them.
  40.  
  41.       ----hhhh        Suppress printing of filenames when    searching
  42.             multiple files.
  43.  
  44.       ----iiii        Ignore upper/lower case distinctions during
  45.             comparisons.
  46.  
  47.       ----llll        Instead of printing    lines from the files, just
  48.             print the names of the files containing lines that
  49.             would have been printed. Each file name is printed
  50.             once, on a separate    line.
  51.  
  52.       ----nnnn        Precede each line by its line number in the    file.
  53.  
  54.       ----ssss        Work silently, that    is, display nothing except
  55.             error messages.  The exit status indicates whether
  56.             any    matches    were found.
  57.  
  58.       ----vvvv        Invert the sense of    the match, so that lines which
  59.             do _n_o_t match the pattern are now the ones that are
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 12/10/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      PPPPGGGGRRRREEEEPPPP((((1111))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV              PPPPGGGGRRRREEEEPPPP((((1111))))
  71.  
  72.  
  73.  
  74.             found.
  75.  
  76.       ----xxxx        Force the pattern to be anchored (it must start
  77.             matching at    the beginning of the line) and in
  78.             addition, require it to match the entire line.
  79.             This is equivalent to having ^ and $ characters at
  80.             the    start and end of each alternative branch in
  81.             the    regular    expression.
  82.  
  83.  
  84.  
  85.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  86.       ppppccccrrrreeee((((3333)))), Perl    5 documentation
  87.  
  88.  
  89.  
  90.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  91.       Exit status is 0 if any matches were found, 1    if no matches
  92.       were found, and 2 for    syntax errors or inacessible files
  93.       (even    if matches were    found).
  94.  
  95.  
  96.  
  97.      AAAAUUUUTTTTHHHHOOOORRRR
  98.       Philip Hazel <ph10@cam.ac.uk>
  99.       Copyright (c)    1998 University    of Cambridge.
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 12/10/98)
  130.  
  131.  
  132.  
  133.